home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat2 / standard / msync.z / msync
Encoding:
Text File  |  2002-10-03  |  4.9 KB  |  132 lines
  1.  
  2.  
  3.  
  4. mmmmssssyyyynnnncccc((((2222))))                                                              mmmmssssyyyynnnncccc((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _mmmm_ssss_yyyy_nnnn_cccc - synchronize memory with physical storage
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_mmmm_mmmm_aaaa_nnnn_...._hhhh_>>>>
  14.      _iiii_nnnn_tttt _mmmm_ssss_yyyy_nnnn_cccc_((((_vvvv_oooo_iiii_dddd _****_aaaa_dddd_dddd_rrrr_,,,, _ssss_iiii_zzzz_eeee______tttt _llll_eeee_nnnn_,,,, _iiii_nnnn_tttt _ffff_llll_aaaa_gggg_ssss_))))_;;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      The function _mmmm_ssss_yyyy_nnnn_cccc writes all modified copies of pages over the range
  18.      [_a_d_d_r, _a_d_d_r + _l_e_n) to their backing storage locations.  _mmmm_ssss_yyyy_nnnn_cccc optionally
  19.      invalidates any copies so that further references to the pages will be
  20.      obtained by the system from their backing storage locations.  The backing
  21.      storage for a modified _MMMM_AAAA_PPPP______SSSS_HHHH_AAAA_RRRR_EEEE_DDDD mapping is the file the page is mapped
  22.      to; the backing storage for a modified _MMMM_AAAA_PPPP______PPPP_RRRR_IIII_VVVV_AAAA_TTTT_EEEE mapping is its swap
  23.      area.
  24.  
  25.      _f_l_a_g_s is a bit pattern built from the following values:
  26.  
  27.           _MMMM_SSSS______AAAA_SSSS_YYYY_NNNN_CCCC                 perform asynchronous writes
  28.           _MMMM_SSSS______SSSS_YYYY_NNNN_CCCC                  perform synchronous writes
  29.           _MMMM_SSSS______IIII_NNNN_VVVV_AAAA_LLLL_IIII_DDDD_AAAA_TTTT_EEEE            invalidate mappings
  30.  
  31.      If _MMMM_SSSS______AAAA_SSSS_YYYY_NNNN_CCCC is set, _mmmm_ssss_yyyy_nnnn_cccc returns immediately once all write operations
  32.      are scheduled; if _MMMM_SSSS______SSSS_YYYY_NNNN_CCCC is set, _mmmm_ssss_yyyy_nnnn_cccc does not return until all write
  33.      operations are completed.
  34.  
  35.      _MMMM_SSSS______IIII_NNNN_VVVV_AAAA_LLLL_IIII_DDDD_AAAA_TTTT_EEEE invalidates all cached copies of data in memory, so that
  36.      further references to the pages will be obtained by the system from their
  37.      backing storage locations.
  38.  
  39.      _m_s_y_n_c will fail if:
  40.  
  41.      [EINVAL]       If _a_d_d_r is not a multiple of the page size as returned by
  42.                     _ssss_yyyy_ssss_cccc_oooo_nnnn_ffff(3C).
  43.  
  44.      [EIO]          An I/O error occurred while reading from or writing to the
  45.                     file system.
  46.  
  47.      [ENOMEM]       Addresses in the range (_a_d_d_r, _a_d_d_r + _l_e_n) are outside the
  48.                     valid range for the address space of a process or pages
  49.                     not mapped are specified.
  50.  
  51.      [EBUSY]        MMMMSSSS____IIIINNNNVVVVAAAALLLLIIIIDDDDAAAATTTTEEEE was specified and one or more of the pages
  52.                     was locked in memory.
  53.  
  54. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  55.      _mmmm_mmmm_aaaa_pppp(2), _mmmm_pppp_iiii_nnnn(2), _ssss_yyyy_ssss_cccc_oooo_nnnn_ffff(3C).
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. mmmmssssyyyynnnncccc((((2222))))                                                              mmmmssssyyyynnnncccc((((2222))))
  70.  
  71.  
  72.  
  73. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  74.      Upon successful completion, the function _mmmm_ssss_yyyy_nnnn_cccc returns 0; otherwise, it
  75.      returns -1 and sets _eeee_rrrr_rrrr_nnnn_oooo to indicate the error.
  76.  
  77. NNNNOOOOTTTTEEEESSSS
  78.      _mmmm_ssss_yyyy_nnnn_cccc should be used by programs that require a memory object to be in a
  79.      known state, for example, in building transaction facilities.
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.